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This card summarizes information in the Apache documentation, 
which can be found at http: //www.apache.org/docs/. 

Each directive is listed with its arguments. Defaults are given 
where appropriate in parentheses at the end of the line, followed 
by an indication of the status of the directive (C — core, B — base, 
E — extension) and the contexts in which the directive is valid (c — 
in a configuration file, v — within a virtual host section, d — within 
a directory section, a — in an access control file). 

Options and directives that are new for Apache 1.3 are marked Œ, 
while those that have changed are marked Œ. 


Command line options 


httpd [-d directory] [-f file] |-C directive] 
[-c directive] |-L] [-1] [-s] [-v] [-v] [-x] 


-d directory initial value for ServerRoot 

-D parameter define parameter for <IfDefine> 

-f file configuration file (conf/httpd.conf) 

-C directive process directive before reading config files @® 
-c directive process directive after reading config files @® 


-L list available configuration directives and exit @ 
-1 list compiled-in modules and exit (1.3) 
-5 show vhost settings 

-t test syntax of configuration files and exit 

-v print version and build date, and exit 

-V show compilation settings and exit (1.3) 
-X single-processs debug mode 


General configuration directives 
(/usr/local/apache/htdocs)C cv 
(/usr/local/apache)Cc 
AccessConfig filename (conf/access.conf)Ccv 
ResourceConfig filename (conf/srm.conf)C cv 
Include filename Ccvd ŒŒ 
TypesConfig filename (conf/mime.types)Bc 
PidFile filename (logs/httpd.pid)Cc 
LockFile filename (logs/accept.lock)Cc 
ScoreBoardFile file (logs/apache_status)Cc 
ServerAdmin email-addr Cov 


DocumentRoot directory 
ServerRoot directory 


ServerType {inetd|standalone } (standalone)C c 
ServerName name (determined automatically) C cv 
ServerAlias fqdn ... Cv 
ServerSignature {On|Off|Email} (Off) C cvda 
ServerPath pathname Cv 
ServerTokens {Min[imal]|OS|Full} (Full)Cc @® 
BindAddress {*|IP-addr| fqdn} (*)Cc 

Listen |IP-addr:]port-number Cc 

Port portno (80)Cc 

User {username|#userid} (#-1) Cev 

Group { group-name|#group-id} (#-1) Cev 
NameVirtualHost addr[|:port] Cc Œ 
UseCanonicalName {0On|0ff} (On) C cvda 4%) 
CoreDumpDirectory directory (as ServerRoot)Cc (1.3) 
IdentityCheck {On|Off} (off) C cvd 


ClearModuleList Cc 


AddModule module ... Cc 
AddModuleiInfo module text Ecv 
ExtendedStatus {0On|Off} (off)Ec 
Sectional directives 

<Directory {pattern | ~ regex} > ... </Directory> Cov 
<DirectoryMatch regex> ... </DirectoryMatch> Ccv 
<Files {pattern|~ regex} > ... </Files> C cvda 
<FilesMatch regex> ... </FilesMatch> Ccvda 
<Location {pattern|~ regex} > ... </Location> Cov 
<LocationMatch regex> ... </LocationMatch> Cov 
<VirtualHost pattern> ... </VirtualHost> Cc 
<IfDefine [!|parameter> ... </IfDefine> Ccvda 
<IfModule [!|module> ... </IfModule> C cvda 
<Limit method> ... </Limit> C cvda 
<LimitExcept method> ... </LimitExcept> Ccvda 


Logging directives 
ErrorLog { file|syslog|: facility]} (logs/error_log)C cv 
CustomLog file-or-pipe {format-string|format-name} Bev 
[env=[!]var] 
TransferLog file-or-pipe (logs/access_log)Bcv 
HostnameLookups {On|Off|Double } (Off) C cvd 
RefererIgnore hostname ... Ecv 
LogFormat format-string ("sh %1 %u %t \"Sr\" %s %b")Bev 
[format-name| 
LogLevel {emerg|alert|crit|error|warn|notice| (error)C ev 
info|debug} 
format-string can contain literal text and format specifiers: 


a Remote IP address 

sb Number of bytes sent (excluding headers) 

S{var}e Environment variable value 

SE Filename 

Sh Remote host 

S{hdr}i Incoming header value 

$1 Remote logname (from identd) 

%{label}n Labelled note from another module 

%{hdr}o Outgoing header value 

Sp Canonical port number of server 

SP Process ID of child server process 

sr First line of request 

SS Status 

St Time in Common Log Format (CLF) format 

%{format}t Time (format is strftime format) 

ST Time taken to serve the request (in seconds) 

Su Remote username 

SU URL requested 

SV Canonical ServerName of server 

SV Server name as per UseCanonicalName setting 
Performance tuning directives 
Timeout secs (300) Cc 
KeepAlive {On|Off} (On)Cc 
KeepAliveTimeout seconds (15)Cc 
MaxKeepAliveRequests number (100) Cc 
MaxClients number (256) Cc 
MaxRequestsPerChild number Cc 
ExcessRequestsPerChild number Ec 
MaxSpareServers number (10)Cc 


MinSpareServers number (5)Cc 
StartServers number (5)Cc 
ListenBacklog number (511)Cc 1.3) 
LimitRequestBody nbytes Ccvda ŒŒ 
LimitRequestFields number (100) Cc (1.3) 
LimitRequestFieldSize nbytes (8190)Cc 1.3) 
LimitRequestLine nbytes (8190) Cc 1.3) 
SendBufferSize bytes Cc 
RLimitCPU {secs|max} [{ secs|max }] Ccvda 
RLimitMEM {bytes|max} [{bytes |max }] Ccvda 
RLimitNPROC {nprocs|max} [{nprocs|max }] Ccvda 
ThreadsPerChild number (50) Cc 1.3) 
File typing directives 

DefaultType MIME-type (text/html)C cvda 
ForceType MIME-type Bda 
AddEncoding MIME-encoding extension ... B cvda 
AddLanguage MIME-language extension ... B cvda 
AddType MIME-type extension ... B cvda 
DefaultLanguage MIME-language (no default language)C cvda @® 
LanguagePriority MIME-language ... B cvda 


XBitHack {On|Off|Full} 
MetaFiles {On|off} 
MetaDir dir-name 
MetaSuffix suffix 


(Off) Bevda 
(off) E cvda 4%) 
(. web) E cvda @® 
(.meta) E cvda Œ 


MimeMagicFile filename Ecv @& 
ContentDigest {On|0ff} (Off) Ccvda 
ExpiresActive {On|Off} Ecvda 
ExpiresBytype MIME-type expiry-code Ecvda 
ExpiresDefault expiry-code Ecvda 
Header {set |append|add|unset } header value Ecvda 
Mapping directives 

Action {MIME-type|handler-name} script Bevda 
Alias url-path real-path Bev 
AliasMatch url-regex path-replacement Bo @& 
ErrorDocument error-code {string|url} C cvda 


UserDir {directory |DISABLED [user ...]| 
ENABLED user ...} 


(public_html)Bcv @® 


Redirect [status] url-path url B cvda 
RedirectMatch |status] url-regex dest-url Bov @® 
RedirectPermanent url-path url-dest B cvda 
RedirectTemp url-path url-dest B cvda 
Script method script B cvd 
ScriptAlias url-path script-dir Bev 
ScriptAliasMatch url-regex script-dir Bo Œ 
AddHandler handler-name extension ... B cvda 
RemoveHandler extension ... Bda ŒŒ 
SetHandler handler-name Bda 


ImapBase {map|referer|ur1} (http://server)Bcvda 
ImapDefault {error|nocontent|referer|menu (nocontent)Bcvda 


Jurl} 

ImapMenu {none|formatted|semiformatted|unformatted} Bcvda 
RewriteBase url Ecvda 
RewriteCond test-string cond-pattern |flags| Ecvda 
RewriteEngine {On|off} (Off) Ecvda 
RewriteLock filename Ecv ŒŒ 
RewriteLog filename Ecv 
RewriteLogLevel digit Ecv 


RewriteMap map-name map-type:map-source Ecv 
RewriteOptions option Ecvda 
RewriteRule pattern substitution [flags] Ecvda 
Scripting directives 

BrowserMatch regexp var|=value] ... Bev 
BrowserMatchNoCase regexp var[=value] ... Bev 
PassEnv varname ... Bev 
SetEnv varname value Bev 
SetEnvlf attribute regex var|=value] ... Bev 
SetEnvIfNoCase attribute regex var|=value] ... Bev 
UnsetEnv varname ... Bev 
ScriptLog filename Bc 
ScriptLogBuffer size-bytes (1024) Bc 
ScriptLogLength length-bytes (10385760) Bc 


Directory indexing directives 


DirectoryIndex file ... (index. htm1)Bcvda 


ReadmeName filename B cvda 
HeaderName filename B cvda 
IndexIgnore pattern ... B cvda 


IndexOrderDefault {Ascending|Descending} {Name|Date| Bcvda 
Size|Description} 


DefaultIcon url B cvda 
AddAlt "string" file ... B cvda 
AddAltByEncoding "string" MIME-encoding ... B cvda 
AddAltByType "string" MIME-type ... B cvda 
AddIcon icon file ... B cvda 
AddIconByType icon MIME-type ... B cvda 
AddIconByEncoding icon MIME-encoding ... B cvda 
AddDescription "description" file-pattern B cvda 


IndexOptions {+option|-option} ... 
Valid index options are: FancyIndexing, 
IconsHeight=pixels, IconsWidth=pixels, 
NameWidth=n, IconsAreLinks, ScanHTMLTitles, 
SupressColumnSorting, SupressDescription, 
SupressHTMLPreamble, SupressLastModified, SupressSize 


(no options) Bcvda 


Access control directives 


AccessFileName filename ... (.htaccess)C cv 

AllowOverride directive-group ... (A11)Cd 
Valid directive groups are: None, All, AuthConfig, FileInfo, 
Indexes, Limit, Options 

Options {+feature|-feature} ... (All) Cevda 


Valid options are: None, All, ExecCGI, FollowSymLinks, 
Includes, IncludesNOEXEC, Indexes, MultiViews, 


SymLinksIfOwnerMatch 
AuthName realm-name Cda 
AuthType type Cda 
AuthUserFile filename Eda 
AuthGroupFile filename Eda 
AuthAuthoritative {On|0ff} (On) Bda 
allow from f{all|host ...|env=var} Bda 
deny from {all|host ...|env=var} Bda 
order {allow, deny |deny, allow| (deny, allow)Bda 


mutual-failure } 
Require {user user ...|group group ... 
Satisfy {All|Any} 


|valid-user} Cda 
(All)Cda 


(1.3) 
(1.3) 


ae 


(1.3) 


(1.3) 


Proxy/cache directives 


NoProxy {host|domain|ip-addr|subnet} ... Ecv 
AllowCONNECT port ... (443 563)Ecv 
ProxyBlock {*|host|domain} ... Ecv 
ProxyDomain domain-name Ecv 
ProxyPass path url Ecv 
ProxyPassReverse path url Ecv 
ProxyReceiveBufferSize number-bytes Ecv 
ProxyRemote match remote-server Ecv 
ProxyRequests {On|Off} (Off) E cv 
ProxyVia {0On|Off|Full|Block } (Off) E cv 
CacheDefaultExpire hours (1)Ecv 
CacheDirLength number (1)Ecv 
CacheDirLevels number (3)Ecv 
CacheForceCompletion percentage-complete (90) E cv 


CacheGcInterval hours Ecv 


CacheLastModifiedFactor factor (0.1) Ecv 
CacheMaxExpire hours (24) Ecv 
CacheRoot directory Ecv 
CacheSize kb (5) Ecv 
NoCache {*|host|domain} ... Ecv 


Common Gateway Interface (CGI) variables 
AUTH_TYPE Authentication method used 
CONTENT_LENGTH Length of input stream data 
CONTENT_TYPE Internet media type of input stream 
GATEWAY_INTERFACE CGI version 

PATH_INFO URL part after script identifier 

PATH _TRANSLATED PATH_INFO translated into filesystem 
QUERY_STRING Query string from URL (if present) 


REMOTE_ADDR IP address of client 
REMOTE_HOST DNS name of client 
REMOTE_IDENT Remote user id (unreliable) 
REMOTE_USER Name of the authenticated user 


REQUEST_METHOD 
SCRIPT_NAME 
SERVER_NAME 
SERVER_PORT 
SERVER_PROTOCOL 
SERVER_SOFTWARE 
HTTP_ACCEPT 
HTTP_REFERER 


HTTP request method 

Virtual path of the script 

Host-name of the server 

Port number of server 

Name and version of the protocol 
Server software name and version 
MIME types the browser will accept 
URL of referring document 
HTTP_USER_AGENT Client software identification 
MOD_PERL Defined if running under mod_perl 


Server Side Includes (SSD 

Format is: <!--#element attr=value ... --> 

Elements are: 

config controls parsing; attributes: errmsg, sizefmt (one of 
bytes or abbrev), timefmt (strftime format) 

print the value of a variable; attribute var (can be 
a CGI variable or one of: DATE_GMT, DATE_LOCAL, 
DOCUMENT_NAME, DOCUMENT_URI or LAST_MODIFIED) 
set set the value of a variable; attributes: var, value 
printenv print a list of all variables and their values 


echo 


exec execute a shell command or CGI script; attribute: cmd 
or cgi (IncludesNOEXEC option disables exec) 
fsize print size of file; attribute: file or virtual 


flastmod print file modification time; attribute file or virtual 
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include include another document; attribute file or virtual 
if conditional; attribute: expr 

elif conditional; attribute: expr 

else conditional 

endif conditional 


HTTP 1.1 status codes 
100 Continue 

101 Switching protocols 

200 OK 


404 Not found 

405 Method not allowed 

406 Not acceptable 

201 Created 407 Proxy authentication required 
202 Accepted 408 Request timeout 

203 Non-authoritative information 409 Conflict 

204 No content 410 Gone 

205 Reset content 411 Length required 

206 Partial content 412 Precondition failed 

300 Multiple choices 413 Request entity too large 

301 Moved permanently 414 Request-URI too long 

302 Moved temporarily 415 Unsupported media type 
303 See other 500 Internal server error 

304 Not modified 501 Not implemented 

305 Use proxy 502 Bad gateway 

400 Bad request 503 Service unavailable 

401 Unauthorized 504 Gateway timeout 

402 Payment required 505 HTTP version not supported 
403 Forbidden 


Apache Web Resources 


http: //www.apache.org Apache home page 
http: //modules.apache.org Apache Module Registry 
http: //www.apache-ssl.org Apache-SSL home page 
http: //www.modssl.org mod_ssl home page 
http://java.apache.org The Java-Apache Project 
http://perl.apache.org The Apache/Perl Integration Project 
http: //www.php.net PHP: Hypertext Processor 
http: //www.apacheweek.com Apache Week 
http: //www.netcraft.com/survey Netcraft Server Survey 
http://www.refcards.com Quick Reference Cards 
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